home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / gfx / opal / devdocs.lha / changes.doc next >
Text File  |  1993-05-05  |  2KB  |  44 lines
  1.  
  2.           Changes to opal.library   (04-May-93)
  3.  
  4.             IMPORTANT NOTES
  5.  
  6. You  should  understand  the  issues  regarding  Mode Promotion, horizontal
  7. synchronisation  and  Overscan  intuition screen positioning as outlined in
  8. section  11.9  of  the  developers  manual.   These issues have caused some
  9. problems  with  3rd  party  support,  so  please  take a moment to read and
  10. understand this section.
  11.  
  12.  
  13.           LOADER SAVER INTERFACE (LSI)
  14.  
  15. A  standardised  interface  for loader and saver programs has been added to
  16. opal.library,  this will be outlined in a seperate document currently being
  17. prepared.  This document should be available in the next week or so.
  18.  
  19. To  give a brief overview, the library maintains a list of active saver and
  20. loader  modules.   Each  module  makes  itself  available by either calling
  21. AddOVLoader()  or  AddOVSaver(),  and  the  current  list of modules can be
  22. determined  by  calling  GetOVSavers()  or GetOVLoaders().  Each loader and
  23. saver  if  referenced  by  a  unique  name.   The communication between the
  24. modules and the library occurs using standard Exec messages.
  25.  
  26. You  will normally not need to be aware of the loader modules.  The loading
  27. sequence  will  be  handled transparently using the LoadImage24() function.
  28. LoadImage24()  initiates a polling sequence which will check all loaders to
  29. see  if they understand the file format, and use the correct loader for the
  30. image format.
  31.  
  32. To use the saver modules however (other than IFF,Fast or JPEG), you need to
  33. use  the  Export24()  function  which  takes as a parameter the name of the
  34. saver  module.   A  typical  user  interface  would  use  the GetOVSavers()
  35. function to obtain a list of available saver modules for the user to select
  36. from,  once  the  saver has been selected, the name from the list is simply
  37. passed  to  Export24().   Export24()  can accept "IFF","Fast" and "JPEG" as
  38. parameters  and  use  the  correct  functions  to  perfrom  the  save (i.e.
  39. SaveJPEG24() or SaveIFF24()).
  40.  
  41.  
  42.                           Martin Boyd, Opal Technology.
  43.  
  44.